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ABSTRACT 
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I.   INTRODUCTION 


This  manual  is  a  user  oriented  description  of  a  C- 
cal laole  interactive  araphics  p  a  c  k  a  a  e  designed  to  allow 
programmatic  control  of  the  Vector  General  Graphics 
Display  Unit  (vector  qeneral).  A  knowleooe  of  the  C  - 
oroqrammino  lanauaae  and  a  General  familiarity  with  graph- 
ics terminology  are  assumed. 

The  vector  General  is  an  interactive  graphics  display 
system  interfaced  with  r-p  PDP-11/50  comouter.  The 
display  interacts  with  a  PDP-11  user  by  displaying  tMc- 
toral  information  on  t  h  e  surface  of  a  cathoae  rav  tube  and 
by  accepting  inputs  from  external  control  devices.  1 h e 
incuts  are  renuested  ano  processed  bv  PDP-11  computer  c ro- 
orams  that  alter  ano  maintain  the  output  picture  being 
presented  to  the  user. 

'M  i  t  h  the  permission  of  Vector  dpneral  Corp  oration, 
portions  of  the  material  in  sections  I  I  »  I  T  I  /  and  V  have 
been  reproduceo  from  the  Vector  General  Graphics  Display 
Unit  Reference  Manual  (VG  10105b). 


II.   VECTOR  GENERAL  DISPLAY  SYSTEM 


The  vector  general  contains  the  following  features  for 
interactive  interactive  o  r  a  p  h  i  c  s  display: 

Interface  unit 

Uisnlay  controller 

Uiaital  to  analoa  converter 

Victor  qpnprator 

Disolav  monitor 

Character  Generator 

Circle/ A  re  aenerator 

Three  air,ension  coordinate  transform  venerator 
Four  interactive  control  devices  are    corrected  to  the  svs- 
t  e  m  .    The  devices  a  re  l 

Alphanumeric  kevboara 

Ihirtv-two  lighted  function  switches  «  i  t  h  manual  inter- 
rupt 

fen  control  dials 

Light  pen 


Ihe  computer  and  display  controller  communicate  n  y  way 
of  thp  interface  unit  throuoh  three  types  of  channels. 
These  channels  a  r  p : 


Data  Channel  -  Direct  memory  access  channel.  Used  by 
the  vector  general  to  directly  access  memory  without 
interferrinq  with  the  operation  of  the  PDP-11  cen- 
tral o  roc  essor. 

Programmed  Input/Output  Channel  -  Used  to  start  the 
controller  and  acknowledae  interrupts. 

Interruot  Channel  -  Used  bv  the  display  to  interrupt 
t  he  PDP- 1  1  comou t e  r . 


The  d  i  s  o 1  a  v  controller  processes  all  display  functions 
xhile  r  u  n  n  i  n  q  asynchronously  with  the  PDP-11  central  pro- 
cessor. Tbo  controller  also  receives  in outs  from  the 
external  control  devices. 

The  d  i  a  i  t  a  1  to  a  n  a  1  o  o  ccnvertor  converts  the  digital 
values  from  the  display  controller  into  analog  sianal s  for 
use  in  the  vector  oenerator. 

Tr.p  catnooe  r av  tube  oenerates  an  oloctron  beam  that 
shows  as  a  snot  of  lioht  on  the  face  of  the  tube.  An 
electromagnetic  deflection  svste^  causes  the  soot  to  move 
in  a  Direction  on  the  tube  face  in  response  to  s  i  a  n  a  1  s 
from  the  vector  Generator.  An  input  from  the  vector  Gen- 
erator causes  the  trinhtnpss  of  the  spot  to  vary. 

Thp  rethon  o  *  control  lino  the  ^ovenont  of  the  soot  is 
called  the  r a n oo m  scan  method.  This  involves  steering  the 
soot  in  a  straight  line  between  two  points  on  the  display 
screen.  A  series  0f  these  straight  lines  constitute  an 
image.   To  o  r  ^  s  e  n  t  a  c'°^r  i  •"  a  o  e  /  the   pattern   traced   on 


the  tube  must  be  repeated  aoorox  i  ma  t  e  1  y  thirty  to  •forty 
times  per  second.  Each  reoetition  is  calico  a  frame  and 
the  frequency  at  which  it  is  Generated  is  called  the  re- 
fresh rate.  The  default  rate  is  forty  hertz  but  can  be 
varied  from  thirteen  to  one  hundred  twenty  hertz  by  the 
rout inp  vacloc^C). 


A.   VlSlHlh  SPACt 


The  rectamular  portion  o '  the  C^T  which  con  be  viewed 
by  a  yspr  is  called  t  h e  visible  space.  I h  e  v  i  s  i  b 1 e  srace 
is  limited  b  v  an  oca  due  ^as*  with  a  rectangular  cutout. 
See  Fioure  ?  -  !  . 

The  r'an'u,r'  Picture  ^r  ic  is  1  a  r  a  e  r  than  r.hr  visible 
space.  I  hi  s  cerr-i  ts  limited  zoorin  a  nut  primarily  a  1  1  o  v-.  s 
f u 1 1 v  visible  objects  to  be  fotatea  and  nosi t innpi  to  the 
extreme  limits  of  the  visible  space  and  vpf  draw  any 
remainina  visible  portions  wit- hi  out  distortion. 

The  picture  being  oenerated  is  adjusted  in  size 
(scale:)  to  present  the  desired  output  by  means  of  two 
cont r  o 1 s : 

a.  l^e  manually  adjustable   a  a  in   controls   on   the   C  f<  T 

deflect  ion  hardwaret 

P .   1 h e  p  r oa  r  a  m  control  l?o  picture  scale   transformation 

h  a  r  3  * :  a  r  <=  .   5  <~>  p  o  s  c  a  1  (  )  routine  in  section  v  I  . 


Image   Space 

Viewing  Space 
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Dynamic  Range    of  Vector  General  =   Picture  Space 


30    inch 


F  i  n  t;  r  e     ?  "  1  .         '       •  ' 1  f1     >''n\'s 


The  picture  can  he  oenerated  on  a  picture  SDace  coor- 
dinate system  and  scaled  for  viewina  throuah  the  visible 
space.   See  vqoost ()  and  vqpscal ()  routines  in  section  VI. 

\ith  the  aain  control  knobs  at  standard  m  i  d  r  a  n  g  e  cali- 
brated settings,  the  maximum  picture  space  (over  which  the 
vector  aenprator  accurately  rpnroducps  i  m  a  a  e  s  )  is  a  thirty 
inch  r>y  thirty  inch  plane  of  which  the  visible  space  is  a 
thirteen  inch  p  y  fourteen  inch  rectanole  in  the  center. 
See  Figure  <?-!. 


H.   PICTURE  SPACE 


T  n  e  transformation  hardware  oerrrits  the  ceorni nates 
defining  an  element  to  be  transformed  prior  to  display 
erat  ion.  For  t h e  input  cooroi nates  (  x  ,  Y  ,  2  )  the  o  u  t  d  u t 
t  r-mstor^ei  *  an d  Y  are  used  to  oenerate  the  element's 
horizontal  ana  vertical  Picture  space  position  respective- 
ly. Thus,  the  picture  space  is  the  X  - Y  projection  of  the 
transformed  element  definition. 

If  no  transformation  is  Performed*  or  for  zero  rota- 
tion/ zero  displacement,  anti  full  scale  size  transforma- 
tion, an  element  coordinate  (  X  ,  Y  ,  Z  )  will  correspond 
directly  t  c  the  Picture  sooce  ( X ,  Y  )  ,  with  t  r  <=  positive  X 
beinu  horizontal  towards  the  rioht  of  a  vip«er  a r  }  posi- 
tive Y  being  vertical.  with  the  gain  tncns  at  t  "  e  r  a  H - 
b  r  a  t  e  d  settings  and   the   Picture   scale   set   to   n  a  x  i  m  u  ~ 


(1.0)/  a  olus  full  scale  X  element  coordinate  value 
(+2047)  transforms  into  an  X  picture  space  coordinate 
value  which  corresponds  to  a  horizontal  displacement  of 
seven  and  one-half  inches  to  the  riqht  of  center  or  one- 
half  to  the  riqht  of  the  visible  space.  Similarly,  for  no 
transformation  and  maximum  picture  scale,  a  full  scale  Y 
element  coordinate  value  (+P047)  corresponds  to  a  picture 
space  position  seven  and  one-half  inches  up  from  the 
center. 

To  view  a  centerec  two-dimensional  object  defined  over 
the  entire  X-Y  coordinate  ranoe  (such  as  a  oaqe  of  text), 
the  nicture  scale  can  be  set  to  .92  or  the  qain  knobs 
turned  oown.  lo  view  an  entire  centered  three-dimensional 
object  which  is  defined  over  the  entire  (X,  Y,  Z)  image 
space,  a  0. 5  7  7  35  0  factor  is  needed  to  view  the  maximum 
lenqth  of  the  orojected  d  i  a  o  o  n  a  1 s  of  the  i^aoe  space.  The 
picture  scale  is  defined  as  1.0  unless  explicitly  changed 
oy  the  routine  vooscal (). 

Since  the  picture  soace  is  larger  than  the  visible 
space,  each  element  may  be  positioned  out  of  the  viewinq 
area  in  any  direction  without  distorting  any  remainina 
visiole  portions.  This  capability  is  termed  the  hardware 
scissorina  facility. 
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C.   IMAGE  SPACE 

Prior  to  transformation  and  projection  onto  the  pic- 
ture space  an  element  is  defined  in  a  coordinate  system 
referred  to  as  the  imaqe  space.  All  separately 
transformed  objects  of  a  displayed  picture  are  defined  in 
their  respective  untransformed  imaae  spaces. 

The  imaae  space  coordinate  system  is  defined  with 
positive  X  horizontal  to  the  riqnt  cf  the  viewer  and  Y 
being  vertical.  The  Z  axis  is  perpendicular  to  the  X - Y 
plane  and  intersects  the  X  and  Y  axes  at  the  zero  point. 
Positive  Z  is  toward  the  viewer.  The  imaae  space  is  a 
fifteen  inch  bv  fifteen  inch,  rectangle.   S^e  Figure  2  - 1  ■ 

To  exploit  maximum  use  of  transformation  ranaes  ana 
coordinate  resolution*  all  elements  shoulo  be  defined  as 
larae  as  oossiole.  Elements  are  defined  primarily  in 
terms  of  generated  visual  elements:  Vectors  and  Charac- 
ters. 


0.   rH'R.EE-DTMENSIONAL  DISPLAY 

Tnree-dimensional  presentation  involves  a  third*  or  Z , 
axis  that  is  aerpenoicular  to  the  face  of  the  screen  and 
intersects  the  *  and  i  picture  space  axis  at  the  zero 
point.  Ihe  Z  axis  represents  d°pth  into  and  out  of  the 
display  screen.   The  illusion  of  depth  may  be  achieved   by 


1  1 


varyina  the  light  intensity  of  the  fluorescent  spot  in 
proportion  to  the  value  of  the  Z  coorainate.  The  intensi- 
ty increases  exponentially  with  the  intensity  value  over 
the  range  of  minus  full-scale  intensity  to  one-half  full- 
scale  intensity.  Maximum  intensity  is  at  the  face  of  the 
screen,, 


E.   P1C1UKE  CONTROL 

The  oict u re  control  is  used  for  picture  transformation 
after  all  transformations  c  f  i  n d  i  v  i  o u  a  1  objects  have  teen 
comr'efe'i.  Iho  r»oisters  usee)  for  this  feature  rare  the 
twelve  Pit  intensity  offset  reoister,  the  twelve  Pit  in- 
tensity seal p  reaister,  and  the  twelve  tit  picture  scale 
reai  ster.  T^e  value  in  the  picture  scaie  rpcister  is  mul- 
tiplied by  each  of  t^p  transformed  X  /  Y,  ^c  Z  coordinates 
to  estarlisn  t  r.  e  f.i  na  1  d  i  c  t  u  re  size.  This  sc  a  1  i  no  applies 
also  to  characters  in  the  Picture. 

The  intensity  scale  reaister  is  used  in  conjunction 
with  tne  intensity  offset  reaister  to  Provide  aeoth  cue- 
ing* or  shading  of  tne  intensity  of  the  oicture  according 
to  the  values  of  the  I  coordinate.  The  hardware  calcula- 
tions of  the  snot  intensity  at  any  instant  can  he 
represented  bv  the  followino  C-nrcara~mina  1  a  n  a  a  a  a  e 
routine: 


1? 


int  is; 

i  n t  io? 

i  nt  i  ; 

int  i  «-ma  x 

i  n  t  z ; 

int  2 1 ; 

int  k  ; 

int  e  ? 


intensity  scale  reaister  value 

intensity  offset  register  value 

resulting  intensity 

maximum  intensity 

transformed  Z  coordinate  value 

constant 
2.718281R284 


z\  =    0.5  *  abs(is)  *  z  t  io; 

if  (is  >  =  0  8.  &  z\     <-     .02)  i  =  i  <-  m  a  x  *  e  **  (  k  *  z  1  )  ; 

if  (is  >=  0  8.8,  zl  >  .02)  i  =  saturation; 

if  (is  <  0  &  &  zl  <=  .02)  i  =  i  <-  m  a  *  *  e  *  *  ( k  *  zl); 

if  (is  <  0  &  8,  is  >  .02)  i  =  0; 


The  intensity  cutcff  plane  is  established  by  the  value 
in  the  intensity  offset  register.  within  thp  o  e  r  t  r  ranae 
of  an  i  m  a  q  e  t  the  intensity  is  b 1  a  n  k  e  a  ret^een  the  viewer 
ana  the  serpen.  Tne  intensity  is  at  its  rr a  x  i  m  u  m  at  the 
face  of  the  screen  and  ipcreases  exponentially  with  de- 
creasing values  of  7  toward  the  r  -  a  c  <  of  the  i  rr  a  a  e  •  Fioure 
2- 3  a  anci  Figure  2 -3b  s^c*  tne  effect  of  intensity  offset 
variation.  As  the  value  in  the  intensity  offset  reii  ?ter 
is  Chan a en,  the  element  "eves  for warn  or  backward  through 
the  intensity  ranae/  to  vary  the  section  that  is  intensi- 
fied ana  the  cart  that  is  blanked  out. 

The  intensity  ranee?  or  aooarent  d  e  o  t  h  of  tne  i  m  a  a  e  > 
is  let  errri  nea  by  the  value  in  the  intensity  scale  reais- 
ter. If  the  value  is  1  . 0 »  the  Taxi-rum  intensity  is 
achieveo.  If  the  value  is  zero*  the  intensity  is  constant 
and  the  element  n  a  s  no  deoth-cueino.  Fiaure  2-^A  and  Fio- 
ure 2 - 4  B  show  hew  a  variation  in  intensity  scale  changes 
the   lent  h  of  tne  e  1  p  ""  e  n  t  . 
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Mqure    c'-^A.        Intensity    Hffset     Variation 


I  a 


Low  10 

Image  Dim 


High  10 
Image  Bright 


Maximum 
Intensity 


VJ/////////////  ///////////////////////// 7///7//7777I 


Outside , 
Blanked 


\ Zero 

Intensity 


Screen 


Fiaure  2-3 B.   Effect  of  Intensity  Offset  Variation 
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Piqure  ?-4A.   Intensity  Scale  Variation 


lb 


Large  Intensity  Scale 


Back  Much  Dimmer 
Than  Front 


Back 
Dim 


Maximum 
Intensity- 


Front 
Bright 


Small  Intensity  Scale: 


All  Nearly  the 

Same  Brightness 


Maximum 
Intensity 


Fiaure  ?-4B.   Fffect  of  Intensity  Scale  Variation 


17 


F.   CHARACTER  GENERATION 

The  character  aenprator  accepts  coded  incuts  from  the 
display  list  and  produces  text  strinqs  composed  of  ASCII 
characters  and  special  characters.  Characters  are  drawn 
on  the  serpen  as  a  series  of  short  vectors  and  curves. 
Unli<e  the  vector  qenerator,  however,  the  character  gen- 
erator draws  are  generated  automatically  by  the  character 
Generator  each  time  a  character  code  is  received. 

Th^  proa  ram  can  select  one  of  four  character  sizes. 
The  intensity  is  determined  by  the  intensity  scale  regis- 
ter. Continuous  char actor  scaling  allows  the  picture 
scale  and  coordinate  scale  to  scale  the  i  m  a  a  e  inn  charac- 
ters proportionally.  The  orocr am  can  also  specify  whether 
the  text  lines  a  r  ^  to  be  disnlaveo  horizontally  on  the 
screen  or  ire  to  be  positioned  as  if  on  a  pane  that  has 
been  rotated  ninety  deqrees  clockwise.  One  of  the  charac- 
ters is  a  cursor.  The  cursor  differs  from  other  displayed 
characters  in  that  the  character  followina  the  cursor  is 
drawn  in  the  same  ol ace  withcut  a  column  feed.  This  per- 
mits t^e  cursor  to  be  moved  over  the  screen  as  desireo 
«  i  t  h  manual  inputs.  A  hardware  feature  causes  the  cursor 
to  blink  twice  per  second. 

The  dimensions  for  character  oenerator  outputs  in 
number  space  units  are  qiven  in  F inure  2-5.  The  stand arc 
character  set  font  is  shown  in  Figure  <?  -  6  .  The  codes  for 
each  Character  can  De  found  in  Appendix  A. 
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G.   CONTROL  CHARACTERS 

Fourteen  codes  in  the  character  set  are  used  for  con- 
trol purposes  only  ana  do  not  cause  a  display  on  the 
screen.  The  control  characters  and  their  functions  are 
listed  in  section  V . 


III.   CONTROL  DEVICE  DESCRIPTION 


A.    ALPHANUMERIC  KFY3CARQ 

The  alphanumeric  keyboard  is  used  as  an  entry  oevice 
for  manual  innut  to  the  display  system.  P res si  no  a  kev  on 
the  keyboard  enters  an  eioht  bit  ASCII  character  coiie  into 
the  kev roar d  character  oueue.  The  character  entered  in 
the  keyboard  character  Queue  does  not  directly  affect  the 
display  on  the  screen.  The  prooraf  can  read  the  keyboard 
character  via  vqaetcarC)  and  use' the  information  in  its 
operation.  H  o  1  d  i  n  a  any  <ey  down  will  maintain  the  correct 
code  and,  after  an  initial  delay*  will  repeat  the  charac- 
ter. Appendix  A  lists  the  codes  oenerated  by  the  keyboard 
for  shifted  and  unshifted  kev  combinations. 
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B.   LIGHTtD  FUNCTION  SWITCHES 

This  Device  contains  thirty-two  function  switches  plus 
a  manual  interrupt  switch.  The  function  switch  registers 
in  the  display  controller  have  one  bit  corresponding  to 
each  function  switch.  W h  i  1  e  any  function  switch  is 
depressed,  the  correspond  ina  bit  in  the  function  switch 
register  is  set.  The  prooram  can  then  read  the  contents 
of  the  reaisters  via  voopt  fsw().  The  function  switch 
lamps  can  be  1  i  o  h  t  e  d  via  vQlamPsO. 

The  manual  interrupt  switch  can  be  used  to  cause  an 
interrupt.  This  feature  allocs  the  operator  to  intercept 
the  prooram  at  any  desired  point.  flhen  the  manual  inter- 
rupt switch  is  pressed,  the  manual  interrupt  counter, 
vnn-anir-t,  i<5  incremented.  The  prooram  mav  reset  this 
counter  when  a e  s  i  r i    : . 


C.   LIGHT  PEN 

The  light  nen  can  Pe  used  to  point  at  an  element  of  a 
display  or  to  create  information  by  drawing  on  the 
display.  The  1  i  q  h  t  pen,  a  wanci  containinci  a  photocell,  is 
hr>la  over  the  face  of  tho  cathode  rev  tube  by  the  viewer. 
/.hen  the  light  pen  is  held  over  a  line  or  point  on  tho 
displav,  the  light  pen  interrupt  f 1  an,  vnlrflao,  is  set  to 
indicate  a  lioht  pen  interrupt  condition.     If   the   lipht 
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oen  switch  is  activated^  the  liaht  pen  sense  switch  inter- 
rupt flaa,  valpsf ln»  is  set  to  indicate  this  condition. 

A  hardware  delav  feature  permits  the  liqht  pen  inter- 
ruot  state  of  the  Vector  General  to  be  obtained  Drior  to 
additional  disolay  processina.  The  values  retained  at 
interrupt  t  i  hip  can  be  obtained  by  calling  vaoetlpnC). 


D.   CONTROL  DIALS 

Ten  control  dials  ^ay  be  used  to  seni  oicital  numeri- 
cal information  to  the  comDu»er  for  a^v  oumose  specified 
by  the  proaram.  fc  a  c  r,  oial  is  associateo  *  i  t  K  a  twelve  bit 
:  l  a  1  inr>ut  reaister  in  tn?  display  controller,  ^3  a  oial 
is  turned,  the  correspond  inn  reaister  is  ucoated  to  re- 
flect the  dial  value.  These  values  rr  a  y  re  read  at  any 
ti~e  bv  calling  v  a  a  i  a  1  (  )  . 


IV.   USUG  THE  VFCTO*  GENERAL 


The  vector  peneral  interface  design  concert  is  to 
define  hioh  level  constructs  which  t  r  e  i^terfacn  routines 
convert  into  vector  general  commands.  I'1  ere  are  three 
classes  of  constructs  define'::  objects/  e'e^orts;  and  the 
picture.   An  object  is  the  lowest   level   construct   which 
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can  be  displayed  alone.  FacH  object  is  i naeoenaen t 1 y 
rotatable,  scalable^  and  translatable  into  any  portion  of 
the   thirty   inch  by  thirty  inch  picture  snace.   An  object 

can  be  as  large  as  fifteen  inches  by  fifteen  inches  and  be 
rotated  or  positioned  to  the  extreme  limits  of  the  Picture 
space  without  distortion  to  any  of  the  r  e  m  a  i  n  i  r  a  visible 
portion.  Each  object  is  composed  of  one  or  core  indepen- 
dently light  pen  h  o  o  w  a  b  1  e  elements.  An  element  is  com- 
posed of  a  s°ries  of  user-ira^n  imaoes  or  characters  rela- 
tive to  the  untransformeo  i  m  a  a  e  space  of  its  onject.  An 
object  ca^  be  defined  unrotaten  in  such  a  wav  as  to  fill 
the  "ntim  object  space  and  tnr>n  be  seal  po;  rotated*  and 
"oven  so  that  the  imaqe  so ace  is  the  appropriate  size*  is 
viewod  from  the  appropriate  aspect/  arid  is  in  the  ap- 
nrcpriatt'  area  of  the  picture.  1  he  picture  defines  the 
picture  sC'i  1  e  an  o  screen  coordinates  tor  all  objects. 

The  uspt  is  responsible  for  the  aeneration  ana  content 
of  each  element.  Prior  to  its  inclusion  within  the 
display  list*  the  user  must  fill  each  element  with  thp 
necessary  craw  and  move  commands.  In  a  d  d  i  t  i  o  n  #  the  user 
must  provide  threp  unused  woros  succeedina  the  ara^-^ove 
Commands.  These  three  words  are  neeoeo  rv  the  interface 
routines  for  omnor  display  list  termination. 

The  Generation  ana  contents  of  all  orjects  a  no  the 
picture  is  the  responsibility  of  the  interface  software. 
A  set  of  routines  are  provided  to  link  elements  to  o ejects 
and   objects   to   the   picture.    Dynamic   modification  c  * 
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objects  and  picture  parameters  is  also  provided.  The 
routines  for  manipulation  and  modification  of  the  display 
data  structure  are: 


vaaddel e  (  a  b  p  ,  n  u  m  , si  z  e ) 

vob  1 ink(typernum,action) 

vaclock(rdtp) 

vqcoord(num,x,y,z) 

vacsr(nu"if  val  ) 

vodelele(nuTt) 

v  oae 1 eob j  ( n um ) 

v  a  a  i  a  1  (abo) 

voqetcart ) 

vaget f sw(abo) 

vqqetlpn(abp) 


vo  i  n  i  t  (  ) 

vgiofset  ( num , v  a  1  ) 

voi  seal  (nurr,  va)  ) 
vol amps  (a bp, act  ion) 
vqlnent  t  ype»  nurr.  »  a  c  t  ion) 
vom  < or  j  (  ) 
vapicture( ) 
vqpost (px»py) 
v  a  p  s  c  a  1  (  v  a  1  J 
varotate(num,x,v,z) 
vqt  e  r^ (  ) 


A i  1  oicture  and  object  d i  s o 1  a v  parameters  a r p  initial- 
ized to  default  values.  Tnp  user  m a  v  t^en  m  o  0  i  f  v  ff?sp 
parameters  as  desired.   The  default  parameters  are: 

Display  -slink  -  Ihe  Picture,  all  objects/  and  all  ele- 
ments are  defined  as  non-rl ink.  voolink()  can  set 
or  clear  the  olink  mode  on  any  of  the  constructs. 

Coorainete  Position  -  f  n  e  X,  V ,  and  Z  coo  ruinates  of 
each  object  are  (0,0/0).  Ihe  routine  vgcoordO  can 
move  ?.^  onject  to  any  area  of  the  i  m  a  a  e  space  by 
varyino  these  coordinate  values. 

Picture  Position  -  The  location  of  the  picture  coordi- 
nates  is   dpfinod   as   the   center   of   t  •">  e   screen 
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(  0  /  0  /  0  )  .   The  entire  picture  can  be  moved  on  the  X  - Y 

Diane  by  callinc  vqpost (). 
Coorainate  Scale  -  The   default   is   one/   the   maximum 

size.    This  parameter  may  be  be  scaled  between  zero 

and  one  by  callina  vacsrO. 
Picture   Scale  -  The  default  is  one.   Weducino  the  pic- 
ture  scale   will   shrink   all    of    the    display. 

vooscal ()  modifies  this  Parameter. 
Intensity  Offset  -  The  maximum  intensity  offset/    value 

of   o  n  e  i     is  set  as  the  default  parameter.   A  call  to 

v  o  i  o  f  s  e  t  (  )  can  reduce  this  value. 
Intensity   Scale  -  Initially  set  to  a  ere,     this  maximum 

value  can  be  reoucea  by  the  routine  vqi  seal  ( ) . 
Refresh   p  a  t  e   -  A  refresh  rate  of  forty  n  e  r  t  z  has  teen 

a  s  s  i  n  ^  e  ~i  as  the  i  °  f  a  u  1  t  value.   voclock  (  )  can  m  o  d  i  f  v 

this  value. 
Light  Pen  Enaol e  -  The  1  i  a  h  t  pen  is  initially  disabled. 

A  call  to  voloen()  will  enable  it. 
Function  Switch  L  a  t  p  s  -  All  function  switch   lamps   are 

extinguished   at   display  time  and  can  be  set  by  the 

routine  val3"T5(  ), 

In  order  to  compile  a  prooran  usino  the  d  i  s  n 1  a  v 
subroutines/  qlobal  ^a-es,  and  structures  the  user  should 
invoke  the  following  state-^nt: 

cc     - f  - 0  filename  - ' v 
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This  will  cause  the  lexical  scone  of  the  vector  oeneral 
display  system  to  extend  throuqh  the  oroqrarr. 

Certain  global  names  and  routines  are  not  visible  to 
the  user.  To  avoid  colliding  with  them,  the  user  should 
refrain  from  defining  external  variables  and  routines  that 
start  with  the  letters  "va". 

The  user  must  preface  his  display  actions  by  a  call  to 
vainitC)  and  should  call  vaterm()  before  process  t  e  r m  i  n  a - 
t  i  ^n  . 


V.   D  [SPLAY  P  STRIJC  1  IONS 


Instructions  usee  in  the  i  i  s  p  1  a  y  s  v  s  t  e m  fall  into  t  ,-.■  n 
main  types:  control  instructions  (usee  to  control  the 
display  ere  ration)  and  out  nut  instructions  (usee  to  Gen- 
erate image  vectors  or  characters  on  the  display  screen), 

A  aescriotion  of  the  control  instructions  and  their 
pf feet  or  the  vector  General  can  be'  found  i^  the  Vector 
General  Graphics  D  i  s  o  1  a  y  unit  Reference  Manual  ( V  G 
101056). 

Tne  following  naraaraohs  contain  functional  descrip- 
tions of  t^e  various  eisnlay-list  instruction  configura- 
tions processed  ny  the  disnlav  system.  Lach  instruction 
discussion  includes  a  format  diagram,  a  listing  of  the 
octal   co  o.°  s   for  t^p  instruction  vari^tio^s,  a  definition 
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of  the  applicable  coder  and  a  description  of   the   purpose 
of  the  instruction. 

The  octal  code  given  assumes  the  instruction  to  be  an 
eighteen  bit  instruction  with  the  first  two  bits  zero. 

Operation  oi  the  cisnlay  system  consists  of  processina 
aata  words  in  accor  nance  with  their  instructions. 
Instructions  that  draw  lines  or  manipulate  text  strinas 
process  the  aata  woras  f  o  1  1 o  w  i  n  a  the  instruction  command. 
The  data  words  qive  the  end  point  coordinates  of  the  1  i  ^  ^  s 
or  character  cooes  of  the  text. 

Data  words  arp  transmitted  in  a  strino  or  Mock  fol- 
lowing the  applicable  instruction.  The  last  data  w  o  r  n  in 
the  strinn  ~ust  contain  a  coo en  terminate  bit*  field*  or 
character  to  inaicate  tnat  it  is  the  last  wora  for  that 
instruction. 


A  .    'v  U  W  D  FORMATS 

The  display  systen-  usns  as  its  Dasic  informational 
element  a  sixteen  oit  word  with  the  bit  positions  numbereo 
zero  through  fifteen  as  shown  in  the  folio  w inn  diagram. 
n*  i  t  zero  is  the  most  significant  bit. 

1  ?       $       a   b   6   7   B   9  li)  11  12  13  n  lb 
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B.   CONTRUI   HISPLAY  INSTRUCTIONS 


1.   No  Operation 


0  0  n  0  0  0 


0 

1 
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3 
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5       6       7 

P       9 

10     1!     12    13    1  a     15 
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0 

//// 

W/////// 

W// 

W////////////A 

Thp  NOOp  instruction  ^-^v  h°  u  ?  e -i  to  Hoi  c  oat  a  or  ao1' 
ir^sse^.  Tk»  information  in  bits  " - 1 5  is  not  interorete' 
by  the  vector  opne^al. 
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<"»  3  0  0  0  0 
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//////// 

Thp  h  L  T  instruction  causes  thp  1  i  s  r  1  a  v  s  v  s  f  e  n  to  cease 
all  op^ratio^s.   No  f  1 1  r  t  H  e  r  i  n  s  t  r  u  c  t  i  o  n  s  cr  oat  a  wc-''?  ?re 
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accepted.  The  disci  ay  system  state  is  set  to  not-run, 
not-wait.  This  command  does  not  disable  any  of  the  vector 
general  interrupts. 

C.   DISPLAY  WRITE  INSTRUCTIONS 

These  display  instructions  ana  their  following  data 
are  output  as  lists  over  the  direct  memory  access  channel 
to  venerate  visual  aisolav  elements.  The  basic  word  for- 
mat is  as  shown  in  the  following  diagram. 


U   1   2       3   U   5   o   7   M   a  1 0  1  1  1  2    1 3  1  '\    1  r3 


0   0   0   1 


VM  (if 
vectors ) 


Modifiers 


Character  or  Vector  Data  List 


J 


The  imaoe  generation  instructions  are  use  a  to  present 
display  elements  consisting  of  solid  lines,  dashed  lines, 
dotted  lines/  or  dash-dot-gashed  lines  between  two  posi- 
tions en  the  disolay  screen. 

The  modifier  bits  (  1 2 -  1 5 )  of  the  image  generation 
instruction  specify  if  the  data  words  that  follow  it  are 
to  he  us  eg  for  characters,  absolute  or  relative  vectors, 
x,  Y,  or  L  auto-incrementing,  or  2D  or  SO  incremental  vec- 
tors. The  instruction  also  indicates  the  tyoe  of  display 
(normal,   gashed,   dot,   or   point)   and   the   incremental 
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resolution  or  character  seal ina  to  be  used. 

The  character  generation  instruction  inoicates  the 
size  of  the  characters  to  be  displayed  and  whether  they 
are  to  be  displayed  horizontally  or  vertically. 

The  following  descriptions  are  given  for  no  transfor- 
mations i  m  o  o  s  o  o  on  the  aeneratea  imaoe  prior  to  oisolay. 
The  user  must  specify  any  desired  transformation  prior  to 
processing  any  disolay  generating  instructions  whose  out- 
put is  to  oe  affected. 

1  .   Vector  Relative 

0  1  i 


0   1 


c. 


7  P 


\?     13  H  IS 


0 

0 

0    1 

////////// 

VM 

0      0 

0      0 

+ 

A   Coordinate 

OF 

CF 

9 

1 

± 

A  Coordinate 

1      1 

CF 

1  he  oisolay  instruction  for  relative  vectors  generates 
a  vector  oisolay  whose  coordinates  are  relative  to  the 
initial  contents  of  the  coordinate  registers*  *R»  Y  K »  ano 
Z  K  .  The  f  ^r'-"  of  disolay  generated  b  v  the  m  o  v  i  n  a  o  e  a  rr  is 
specified  by  the  vector  m o d e  field  ( 'V m  )  . 


3  1 


VM 

00  0 
001 
010 

01  1 
101 
1  10 


VECTOR  '-'OPE 
Line 

Dashed  Line 
Dotted  Line 
End  Point 
Dash- Dot-Dash 
Dash-Dot -Dash 


Trip  operation  field  (OF)  of  each  lata  w  c  r  a  specifies 
if  the  o  e  a  ^  is  to  he  ^ovpri  to  a  new  position  held  in  the 
coordinate  renist°rs#'  al  so»  when  moving  the  beam,  it 
specifies  if  a  vector  t  v  o  e  (  V v )  is  to  op  a  r  a  w  n  .  The  0  f- 
field  also  specifies  the  end  of  t  h  p  data  list. 


OF 
0  0 

0  1 
10 

1  1 


rysv  - ;,  t  i  c\    f  t  f  lh 

Load  ^eoister 

Load/  then  draw  vector 

Load/  move  beam  (no  draw) 

Loadr  draw,  terminate 


Each  oata  word  has  a  s  i  d  n  p  d  twelve  bit  coorainate 
increment  to  he  added  to  a  coordinate  reoister  or  to  the 
auto-increment  reoister  (ATR).  The  coordinate  field  (CF) 
of  e-3ch  data  word  specifies  which  rpoister  is  to  be  updat- 
ed by  tKe  coordinate  increment. 
CF  Qi'^YIiJATF  F1LL0 


Aijto-incrempnt   reoister  (  A  I  P  ) 


T>? 


01 
10 

1 1 


X-coordinate  register  (XR) 
Y-coorainate  register  (YR) 
Z-coorainate  reoister  (ZR) 


To  draw  an  arc  with  the  circle  arc  generator   use   the 
followina  oroceauret 

1.   N'ove  the  beam  or  draw  to  the   start   point   of   the 

arc. 
d.       Loai  the  end  coint  into  the  coordinate  reqisters. 
5.   Issue  an    arc  command,   Th»  arc  commands  are! 


Clockwise  arc 

Counter  c  1  o  c  <  w  i  s  e  arc 


l...  F  -  C  F  fiphs 

onoooa 
0  0  0  0  10 


<4 .  Issue  a  draw  or  draw-terminate  co -r.fr  a  no  to  the 
center  point  of  the  arc.  This  defines  the  radius  of 
the  arc. 

A  circle  may  bP  drawn  hy  either'  usina  the  procedure 
described  ancvp  and  speci  f vi  na  the  same  value  for  both  the 
start  roint  and  end  point  of  the  arc  or  by  leavino  step 
two  of  the  nrocedijre  described  a^  ove  out  entirely  and  just 
moving  or  irawina  to  tt>e  start  point  before  issuing  the 
-ire  command. 

If  the  radius  to  start  and  to  the  end  point  are  not 
ecu  a  1  »    tnp   start-   point    will  b  e  used  and  t  h  «•  circle  n  r  c 
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generator  will  use  either  the  X  or  Y  coordinate  for  ter- 
minating the  draw  in  accordance  with  the  following  Di- 
agram. A  straight  line  will  be  drawn  from  the  terminating 
point  on  the  radius  and  the  specified  end  point. 


Use  X 


Use  Y 


'   Center  Point 


Use  Y 


Use  X 


2  .        Vector    cpl.-itivp  &  u  t  o  -  * 


0  1000  1 


() 

1 

c 

3 

n      5      b      7 

Q      10      11 

12     13 

!   i     IS 

0 

0 

0 

1 

W////////A 

VI-1 

0      0 

0      1 

± 

6  Coordinate 

OF 

CF 

+ 


A  Coordinate 


1   1 


CF 


The  display  instruction  for  vector  relative  a  u  t  o - X  is 
orocessed  as  a  relative  vector.  Fach  coordinate  value  is 
added  to  the  register  a e  s i  d n a  t  e  d  t  •  y  C  F ;  then  t  K  e  vector 
Generator  pprfnr^s  a  n  v  function  specified  P  v  viv'  and  V  r  . 
.'•ith  each  nove  or  draw  ooeration*  t  n  e  ^-conroinatp  r  e  o  i  s  - 
ter  (Xr'J   is  incremented  Py  the  value  in  rhe  auto-increr^nt 
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reqister  (M^)  fol  lowinq  the  load  instruction  but  precea- 
ina  the  ^ove  or  draw  corrnnand  of  the  operation. 

The  tyoe  of  vectors  qenerated  is  specified  by  V M  as 
described  above. 

Control  of  ceam  motion  and  blankino  or  list  termina- 
tion is  specified  by  OF  as  described  for  relative  vectors. 

Specification  of  the  reqister  to  oe  incremented  o  y  the 
coordinate  value  is  oiven  by  CF  as  described  above. 

3 .    Vector  ^rlat i yp  fluto-y 
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Ire  display  instruction  for  vector  relative  autO-Y  is 
processed  as  a  relative  vector.  t  a  c  h  coordinate  value  is 
adoed  to  the  r»ni  ster  designated  by  CF;  t^en  the  vector 
•pneratc"  performs  any  function  specified  by  ."  a  n  h  OF. 
i'.'ith  e^Ch  ~ove  or  draw  operation  the  y-conrf!inato  reqister 
'>••)  is  incremented  o  y  t  h  <=>  value  in  t  ^  e  r-!d-i-i"cr°"ent 
reqister  (  ^  i  >v )  fol  lowing  the  1  o  a  o  operation  rut  p  r  e  c  e  o  i  n  a 
the  move  or  draw  portion  of  the  operation.  The  V  ;v  >  OF, 
a n d  C F  fields  are    as  described  for  relative  vectors. 
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4  •       Vector    Relative    fluto-Z 


0  10  0  0  3 


0        1 

? 

3 

a      5      6      7      « 

f  ^     10     11 

12    13 

14     15 

0     0 

0 

1 

r////////// 

VM 

0      0 

1       1 

+ 

A  Coordinate 

OF 

CF 

A  Coordinate 


1   1 


CF 


The  display  instruction  for  vector  relative  auto-Z  is 
processed  as  a  rp|atn°  vector.  tac^i  coordinate  val  is 
added  to  the  r  e  a  i  s  t  e  r  desinnateri  hv  C  F  ?  then  the  vector 
generator  oorf?r-s  any  function  snec  i  f  iea  by  .  ana  h. 
with  each  ":Ove  or  draw  operation,  tne  Z  coordinate  r  e  a  i  s  - 
ter  ( / -  )  is  incremented  by  the  value  in  the  auto-incre  - 
register  (  fiH  )  following  the  I  c  a  d  portion  rut  precedina 
the  Tove  or  -1  r  a  *  portion  of  tne  operation.  The  V  "•■  r  I  F  , 
ana  C  F  fields  are    as  described  for  relative  vectors. 
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5.   Vector  'osolute 
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The  vector  absolute  Hi  ?ol  av  instruction  loan*;  t  h  p 
coordinate  va'up  from  e-u^  of  its  riata  words  directly  into 
jre  rpni  9t  °r  scecifipd  b  v  <~F,  r  o  p  1  ^  c  i  n  o  t  *  p  previous  c  o  n  - 
tpnt-s.  The  bea**  position  is  ^cve'i  it  called  'or  by  OF  and 
a  vector  n  f  tv"p  V  '"•  is  drawn  if  r  p  au  i  r  e  d  ^  v  C  ^  .  T  n  p  V  N  , 
Lj  F  ,  y  no  C  ^  f  i  o  I  .-^  s  fop  absolute  vectors  are  t  n  o  ss-p  a  ^ 
dPScrioeO  for  vector  relative. 

lo  draw  an  arc  usino  the  rircln  arc  qpnerator  use  the 
procedure  d^scrinpd  for  v^c^or  relative. 
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b.   Vector  Absolute  A  u  t  o  -  X 
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The  a  i so  lav  instruction  for  vector  absolute  a  u  t  o - x 
processes  its  data  list  as  absolute  vectors.  Each  coordi- 
nate value  is  loacipc  into  the  reaister  aesiqnated  t  >  y  C  F  ; 
then  the  vector  oenerator  nprfor^s  any  rove  or  V  M  type 
draw  operation  if  called  for  b  v  OF.  »» i  t  h  each  d  r  a  v  c  r 
move  operation,  t ne  X -coord  in  ate  register  (XR)  is  incre- 
mentea  by  a  d  a  i  n  q  tie  value  frorr  the  auto-increment  r  e  o  i  s  - 
tpr  (AI^)  foll^wina  the  loan  nortion  but  nrecenino  the 
move  or  draw  portion  of  the  on  oration.  Ihe  VN'r  OF,  C  F 
fields  are  used  as  described  for  vector  relative. 
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7.   Vector  Absolute  Auto-Y 
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The  nisplav  instruction  for  vector  absolute  auto-Y 
processes  its  idta  list  as  absolute  vectors.  bach  croroi- 
nate  value  is  loaned  into  the  reciister  oesiqnatert  tiy  CF; 
then  the  vector  qpnerator  p  eriorms  anv  move  or  V1'  t  yoe 
draw  operation  if  called  for  ry  OF.  rtith  each  draw  or 
1-ove  operation,  the  f-coordinate  register  (  r  ^  )  is  incre- 
mented by  adding  the  value  f ro^  thp  auto-increment  r e  o  i  s - 
t  e  r  ( A  I  k  )  f  o  1  1 o  a  i  n  a  the  loan  portion  but  preceding  the 
move  or-  draw  portion  of  the  operation.  The  V  N'  #  OF;  C  F 
f iel is  are  used  as  described  for  vector  relative. 
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8.   Vec  tor  Absolute  Auto-Z 
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The  d  i  s  o 1  a  y  instruction  for  vector  absolute  suto-Z 
processes  its  data  list  as  absolute  vectors.  i  c  h  coordi- 
nate value  is  1  o a d e a  into  the  reatster  designated  by  CF; 
then  the  vector  generator  Performs  any  reive  or  \r-  tvoe 
draw  oppr^t  to^  if  called  for  by  OF.  '.  i  t  h  each  ir 
neve  operation,  tne  Z-coordinate  reqister  (,/P)  is  inert- 
menteo  by  addinq  the  valu°  from  the  auto-increment  regis- 
ter ( fl  I  h )  folio  w  i  n  a  the  load  portion  out  preceaino  the 
n^ove  or  draw  portion  of  the  operation.  The  vv,  OF »  CF 
fields  are    used  as  described  for  vector  relative. 
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9.   Incremental  Vectors,  2D 
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The  2 1)  incremental  vector  d  i  s  n  1  a  v  instructions  opn- 
e  r  a  t  e  a  ^  X  Y  vector  display  i^hose  coordinates  3  r  e  relative 
to  t^e  initial  contents  of  the  coordinate  r  e  "'■  l  s  t  e  r  s  . 
■'ilsci  t  h  e  rr  a  *  i  -  ■  j  t  p  c  s  s  i  o  1  e  d  a  t  a  rate  has  '  e?"  acurlea  ana 
the  storaop  requirements  h  a  1  v  e  o  (over  those  of  relative 
vectors).  This  is  "lone  nv  reducina  t  ^  ^  coordinate  data 
field  d  y  seven-twelfths  and  d  a  c  k  i  n  a  two  values  re  r  data 
word.  This  Derf.ormance  increas"  can  be  exploited  where 
the  lo^er  resolution  cat  a  is  adeauate  a^'i  t"~e  nrocessim 
of  packed  values  is  not  detrimental.  The  applicacility  of 
incremental  vectors  is  enhanceo  t  y  t  n  e  scale  field  (S) 
whicn  permits  the  data  values  to  be  applied  as  increments 
over  a  c  e  a  r  s  p  or  fine  orid. 
Jl      I' - 1 "' t •■' h  .  T  " r  : ■  t 

.  r.  maanification:   a  d  H     to  seven  1  o  w  -  o  r  d  e  r  nits 
1       ,-  a  a  n  i  f  i  e  d  :   9  on     to  seven  high-craer  tits 


ai 


by  soec  i  f  y  i  no  T>aqni  f  i  cat  ion,  the  coordinate  increments  are 
added  to  the  hiqh-orcer  bits  of  the  register  heinq  updat- 
ed? otherwise  the  increment  is  s i on-e x t ended  and  added  to 
the  low-order  bits: 

0   1  i       3   4   5   6   7   H   9  10  11  12  13  1«  15 


± 

Coordinate  Register 

'     /, 
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A  Increment 


(No  Scaling) 


-i 


A  Increment 


(Magnified  Scaling) 


The  t  v  p e  of  display  qeneratea  by  the  ^ovino  p  e  a  m  is 
specified  by  the  vector  mode  (  V ■'•' )  field. 

The  1  -  f  i  e  1  o  of  the  incremental  vector  o  a  t  a  word  con- 
trols beam  b 1  a  n  < i  n  q  for  procession  of  the  entire  data 
a  o  r  o  . 


1  Ii\iU  ■■■■SI  T  Y     FULD 

0 


1 


v  o  v  e  beam  with  no  intensification 
f-'ove  oeam  ana  draw  vM-tyoe  vector 


The   last   bit  of  s^     incremental  vector  data- 
is  used  to  f 1  a o  the  end  of  the  data  list. 
j_      if  ;--t.:.  I  F  F  IhLH 
0 
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list  a  o  r  d 


Continue  data  list 
Last  word  of  data 
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10.   Incremental  Vectors?  2D  Auto-X 
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The  d 0  a  u  t  o  -  X  a  i  s  o  1  a  y  instruction  aenerates  a  two- 
dimensional,  relative  vector  display  fro-  racked  Data 
\  nr  perron  t  s  ;  nut  the  data  words  supoly  onl  v  the  y  incre- 
ments.  J  he  corresooncina  '-l^crp-^erits  are  t  e  <  en  as  the 
constant  held  in  the  auto-increfpnt  register  (AIR).  This 
further  doubles  the  possible  vector  rate  ana  halves  the 
T>e"~ory  reaui  regents  for  the  displays  such  as  orapfis  where 
one  coordinate  is  stecned  Dv  a  constant. 

Each  data  worn  supplies  two  f-increrr>ents  and*  there- 
fore* is  used  to  qenerate  two  vectors. 

T  h  e  S  *  v  •' ,  I  ,  ano  I  fields  are  c  o  d  e  a  ana  used  as 
described  for  incremental  vector  2 0  *  but  the  I  - f  i  e 1 d  ap- 
plies to  both  vectors  Generated  fro^  its  data  worn,  ana 
po t  r,  vectors  are  aenerateo  f  rrT  the  fin^l  data  word. 
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11.   Incremental  Vectors/  2D  Auto-Y 
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The  2U  autO'Y  disci  ay  instruction  Generates  a  two- 
m  "-ensic^al  »  relative  vector  d  i  s  o  1  a  y  f  r  o  ^  packed  data 
increments?  rut  the  oat  a  i/ords  Supply  cni  y  the  X  incr^- 
m  e  n  t  S .  (He  correspond  inn  Y-increnents  are  ta*en  as  the 
constant  held  in  the  auto-increment  reoister  (  ^  I  h  )  .  This 
further  gouMps  the  possible  vector  rate  and  halves  the 
memory  requirements  for  the  displays  such  as  qrachs  where 
one  coordinate  is  stepped  by  a  constant . 

Each  clata  word  supplies  two  X-increments  and*  there- 
fore* is  used  to  oenerate  two  vectors. 

The  S#  V M t  It  ana  T  f  i  e  1  a  s  are  coned  ana  used  as 
cescrii'  for  incremental  vector  2 D  t  Out  the  1  -  f  i  e  1  o  ap- 
plies to  roth  vectors  apnereten  from  its  oat  a  word*  ana 
both  vectors  are  oen^rated  from  t  h <=>  final  o a t  a  noro. 
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1 2 .   I nc  rpment a  1  Vectors*  Three  Dimensional 
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The  3D  incrp-nntal  vector  disolay  instructions  aer- 
e  r a  t  e  an  X  Y Z  vector  display  w nose  coordinates  are  relative 
to  trie  initial  contents  of  the  coordinate  reaisters, 
Also*  the  maximum  nossihl p  data  rate  has  been  increased 
and  the  storsae  reaui  regents  r  e :  i u  c  e  d  (eve"  those  of  rela- 
tive vpetes)  .  This  is  To^e  by  shortening  the  coordinate 
data  field  width  sevpn-t^el f ths  ana  d  o  c  <  i  n  q  up  to  two 
values  per  data  word.  This  performance  i  n  c  r  p  a  s  e  c  3n  he 
exploited  where  the  lower  resolution  data  is  aoeauate  ana 
the  orncessina  of  packed  values  is  not  detrimental •  The 
applicability  of  incremental  vectors  is  enhanced  by  the 
scale  field  (3)  which  permits  the  data  values  to  be  at- 
plied  as  increments  n  v  °  r  a  c  o  r)  f  <;  p  or     f  inp  arid. 

Jne  vector  is  aene rated  for  every  two  oat  a  woros   pro- 
c  es  sed . 

The  S*  V"-1*  I*  =»nd  T   fields   -irp   coded   and   used   as 


as 


described  for  incremental  vectors,  2D. 


1 3  .   C  h a racter  Generation 
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Character 


00010100 


Ihp  character  aeneration  d  i  s  c 1  a  y  instruction  processes 
its  3  a  t  a  as  a  string  of  <  t  e  n  d  e  n  ASCII  character  cooes 
packed  two  per  word. 

Each  successive  char.ic'T  'lisp  lavs  a  sydol  or  per- 
forms a  control  function  until  terminate  character, 
A  b  C I  I  cone  D  C  U ,  is  orccessea  sianal  ina  the  end  of  the 
instruction's  o  a  t  a  list. 

The  symbols  available  include  all  of  the  ninety-six 
ASCiT  crachicSf  plus  a  standaro  set  of  ninety-six  a  a  a  i  - 
tional  sysmbols  (programming,  math,  uree<,  etc.)?  ana  an 
optional  set  of  32  user-specified  special  symbols. 

jno  standard  symbols  a  no  their  c^cps  ar^  ni-jpn  in 
Appendix  A . 

The  ijrpction  fieln  (v.)  when  s^t  causes  the  characters 
to   be   disp'avpo   as   if  on  a  paqe  which  has  been  rotated 
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ninety  oeqrees  counter  clockwise. 

fc       CHARACTER  '/.RITF-DIRECTION 

U       h  rite  characters  horizontal  I y 

1      write  characters  vertically 


The  size  field  (SZ)  is  used  to  specify  one  of  the  f  o  i ;  r 
available  strinq-controlled  character  sizes.  The  s  i  z  *  - 
enable  bit  ( E  )  causes  t  n  e  contents  of  the  SZ  f  i  e 1 o  to  be 
instateo  as  the  new  character  size  for  the  subsequent 
cnaracter  Generation. 

t      SI  CHARACTER  Size  C('''T^)L 

U       XX       Use  previous  character  size 

1       U  0      Set  size  to  one  h  u  n  q  r  e  d  columns  D  y  sixty 

1  inos 
1      0  1      Set  size  to  eiohty-one  columns  by  f  i  r  t  y  - 

one  lines 
1       10      Set  size  to  sixty  columns  by  thirty  lines 
1      11      Set  size  to  thirty-two  columns  by  sixteen 
lines 


DFLF  Tr 
NULL 


CONTROL  CHARACTERS 


FUNCT  10! 


r  o  display  is  qenerate<i  and  the  b  *>  a  m 
is  not  s t e n n e d  to  the  npxt  character 
Same  as  DELETE. 
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BACKSPACE 


LINE  FEED 


FORV  FEED 


CARRIAGE 
R  E  1  U  R  N 


DC1 


OC^ 


DC  3 


DC4 


Causes  the  positioning  to  revert  to 
the  previous  character  position. 
Causes  the  current  line  poistion  to  be 
increased  by  one  line. 

Instates  the  current  character  posi- 
tioning at  the  first  character  of  line 
one  • 

Resets  the  current  column  position  to 
position  one*  the  left  m a  r  o  i  n t     and 
increases  t ho  current  line  position  ny 
one  line. 

Reduces  the  current  line  ocsi  t  icn  c  y 
one  line. 

Decreases  the  current  character*  size 
cv  o^e  si?e.   pern-itc-  subscript  a  no 
superscript  sized  to  be  emoeodeo  in 
text.   Size  z  p  r  o  is  channel  to  size 
t  h  ree  . 

Increases  the  current  character  size 
ry  one  size.   Size  three  is  changed  to 
size  zero. 

v  h  e  n  e  r-  c  o  d  e  a  in  a  display  list/  this 
code  terminates  the  data  associated 
with  a  character  Generation  instruc- 
tion. If  i  n  du  t  via  the  Keyboard*  it 
is  interpreted  as  a  process  termina- 
tion c  o  a  e .   It  has  t  h  p  same  a  4  f  e  c  t  as 
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DLL 


tsc 


hOKIZl  i  TAL 

VERTICAL 

I  A  n 


the  "rubout"  key  on  a  DATAKEDIA  termv 
nal  , 

tohen  encoded  in  a  di  sol  ay  list*  this 
cede  is  ignored,    ,'i  h  p  n  i  n  n  u  t  i  r  o"~     the 
keyboard*  it  is  interpreted  as  a  com- 
mand to  clear  all  characters  f rcr  the 
keyboard  character  Queue. 
when  encoded  in  a  d  i  s  r 1  a  v  list*  this 
cone  is  ianored.   i\hen  incut  fro^  the 
keyboard*  it  is  inters re  ted  as  an 
esc er e    code  for  the  npxt  character. 
r'l'hen  fc^C  is  depressed*  tip  r-->»!  char- 
acter will  be  oasseo  as  a  a  t  a  r  e  o  a  r  o  - 
less  of  the  content.   [His  allows  the 
0  C  -i  c  c  :  e  to  be  innut  j '-  rata  *  r  ~  t  r  p 
keyboard. 

Resets  the  current  column  rcsi  t  ion  tc 
horizontal  center  an*"i  increases  the 
Current  line  position  ^  v  one  line. 
Instates  the  current  ch^racter  posi - 
t  ionin'i  to  horizontal  center  of  M^ 
one  . 
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VI.   USER  ROUTINES 


The  description  of  the  user  routines  are  describee  in 
the  same  format  as  the  routine  descriptions  qiven  in  the 
Unix  Reference  Manual. 


SO 


vqaddob  j 


Mar  15  197b 


vqadoob  j 


NAMt : 


vgaddobj  -  add  object 


SYNOPSIS: 

vgaddobj (num) 

int  num ; 


DESCRIPTION: 

The  object  indicated  by  num  is  aoded  to   the   active 
display  list. 

Norrral  return  is  zero. 


D  I  AGNUS  1  ICS: 

All  errors  are  indicated  by  n  e  o  a  t  i  v  e  return   values. 
The  error  values  and  their  m  e  a  n  i  n  a  s  are  as  follows: 
-  1    Tne  object"  number  is  neoat  i  ve»  ?  <*  r  o  r     or  greater 

than  the  rpaximum  oermitted  in  the  system. 
- d  The  object  doesn't  exist 

-3    The  picture  cannot  link  any  rr.ore  objects 
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vqadde 1 e 


Mar  1 5  1976 


vqadde 1 e 


NAME: 


vgaddele  -  add  element 


SYNOPSIS: 

vqaddele(abp/num,size) 
i  n  t  *  adp ; 

int  num,size? 


DESC^IPT ION; 

abn  is  a  Pointer  to  a  d  i  s  d  1  a  y  list  with  all  draw- 
move  commands  defined.  T  h  e  hyte  count  of  the 
display  list  is  the  parameter  size.  This  value 
includes  t^e  three  words  (six  bytes)  that  must  t>e 
added  after  the  oraw-novp  commands.  The  disolav 
list  is  linked  to  the  object/  num. 

The  value  returned  is  the  element  number  of  the 
oisplav  list  ano  should  bp  retained  for  subsequent 
elprrent  identification. 


DIAGN0S1 ICS: 

A!  1 


errors  are  i  n d  i  c  a  t  e d  by  n e qa t  i  v e  return  values 
The  error  values  and  their  meanincs  <)  r  p     as  follows: 


-1  The  object  n  u  m  r  e  r  provided  is  n  e  a  a  t  i  v  e  or  ??ro. 

-  d  The  o  r>  j  e  c  t  has  not  been  defined  b  v  v  a  m k  c  b  j  (  J  . 

-  3  The  o  o  j  e  c  t  cannot  link:  additional  elements. 

"4  Tne  system  has  oenerated  the  maximum  numoer   of 

elements  oermitted. 

-5  The  disolav  list  is  less  than  six  rytes  lono. 

- b  The  disolay  list  buffer  pointer  is  zero. 


SEE  ALSO: 

vQ^kobj () r  vgdeleleC) 
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vqb link 


Mar  15  1976 


v  a  b  1  jnK 


NAME: 


vgblink  -  set  or  clear  display  nlin<  mode 


SYNOPSIS: 

v  q  b  1  ink(tyoernurr,  action) 
char  t  yne  >  ac  t  i  on ; 

i  n  t  nun) 


DESCRIPTION: 

The  display  b  1  i  n  w  mode  of  the  entire  cicture»  a  sin- 
ale  oojectf  or  a  sinate  element  fay  be  set  c  r 
cleare.L   The  f  o  1  1  o  w  i  n  a  parameter  values  a  r  r  1  y  : 

TYPE  : 

0  -  Modify  the  entire  Picture. 

1  ■*  ■•' o  d  i  f  y  the  object/  num. 
?     -  Modify  the  olp-npnt  »   num. 

A  C  T  I  0  N  : 

0  -  Clear  t  h  e  display  blink  mode 

1  "  Set  the  display  blink  '-ode 

" o a i  f  y  i  n o  the  blink  m n d e  of  an  object  affects  all 
elements  linkeo  to  that  object.  L  i  <  e  w  i  s  e  /  rroditica~ 
t  ion  of  the  picture  effects  all  objects  cc.^nsr  i 
the  oicture. 


The  normal  return  value  is  a  zero. 


DIAGNOST 1CS: 

All   errors  are  indicated  by  negative  return  values. 

The  error  values  and  their  npanino^  pre  as  follows! 

-  1    Object  number  is  n e  o a  t  i  v  e  or  ;ero, 

"2  The  onject  or  element  does  no'  exist. 

-a  Tre  element  number  is  negative*  /•  ~  i  c -r 
oreater  than  the  maximum  number  c  f  p1  f:"  J°r  '■  per- 
mitted in  the  entire  system. 
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vac  1 oc k 


iVar  15  19  7ft 


v.:clcc< 


NAMt: 


vqclock  "  set  refresh  rate 


SYNOPSIS: 

vqc 1 oc  k ( rat  e  ) 

int  rate? 


DE SCRIPT  ION: 


Set  the  refresh  rate  of  the  display. 
rate/    is   in  hertz. 


r  h  e  parameter, 

value  s h -     c  e  an  intecpr 
divisor  of  one  hundred  twenty.   I  * e   default 
display  initialization  is  forty  h  e  r  r  ?  . 


v  a  I  ii' 
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vacoord 


Mar  IS  1976 


vqcoo  rd 


NAMt  : 


vqcoord  -  modify  object  X-,  Y-,  and  Z-coordinates 


SYNOPSIS: 

vgccord(num,x,y,z) 
int  num  r  x  r  y  r  Z  i 


DESCHIPT ION: 

The  image  space  X,Y,Z  coordinate  values  of  the  ob- 
ject* nu.ii/  ^rp  set  to  the  values  of  x/y»z  resopc- 
tively.  bach  coordinate  point  of  all  elements 
linked  to  the  object  is  translated  hv  the  x , y , / 
values  at  display  time.  [he  cont^^t  s  of  the  origi- 
nal display  list  refrain  unchanoed. 


The  ranop  of  values  is  -20^17  thrr 
s  y  s  t  e  rr  1  e  f  a  u  1  t  is  z  ^  r  o  for  the  *  » 
nates. 


•■  i  - 


The  normal  return  value  is  zero. 


DI  AGfJOSl  1CS: 

All  prrors  h  r  e 

The  error  value 

-1  The  object 

-'£  i^e  op  j  ec  t 


i  n  d  i  c  a  t  e  d  by  n  e  q  a  t  i 

ana  their  rr  p  a  n  i" 
number  is  neaative  ■ 
is  riot  defined. 


?  f 
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vqc  s  r 


Mar  15  1976 


vncsr 


NAME: 


vqcsr  -  modify  object  coordinate  scalp 


SYNOPSIS: 

vacsr(num,val ) 

i  n  t  nu^; 
doub 1 e  va 1 > 


DESCKIPT  I  ON  r 

Chance  the  i  Taoe  so  ace  coordinate  s  c  a  1  <= 
j  e  c  t  >  n  u  m  ,  to  v  a  1  .  t  a  c  h  coordina,"cs  of 
linkea  to  the  object  is  scaled  to  */  a  I 
tir^e.    The   contents   of   the  o  r  i  o  i  n  a  ' 

regain  unchanoen. 


f    r  n  p   r  .'  - 

II   Plfrn.ts 

at    lis:  i  a v 
i  s  c  1  a  •/  Ms* 


The  ranae  of  v  ^  1  is  ?  e  r  o  to  one. 
is  on",   the  rr  a  x  i  n  u  n     s  c  O  1  r  . 

IhP  n  o  r  rr  a  1  return  value  is  zero. 


DI AGNUS  1  I  CS: 

A  11   errors  are  indicated  t  y  ner.    *      r *•• t 
The  nrror  values  ar^  their  rr  e  a  n  i  n  o  s  ■  -  • 
-  1    F  h  e  object  nun-ber  is  n  e  a  a  t  i  v  e  or  <?  e  r  c  . 
- £.  The  ooj^cf  is  not  defined. 


- 


SEE  also: 

vaosc  a  1  ( ) 


LIMITATIONS: 

Neoative  input  values  cans?  the  coordinates  to 
be  inverted.  This  aives  the  appearance  of  view- 
ing the  orject  f ron  the  neoative  L     axis. 
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vqde 1 e 1 e 


Mar  15  1976 


vode 1 e 1 e 


NAME : 


vqdelele  -  delete  element 


SYNOPSIS: 

vgdel ele(num) 
i  n  t  nu1^; 


DESCRIPTION: 


Remove   the   element/   num» 

The  contents  of  the  display 

however,   the   c  i s  n 1  a  y   cannot   ro 

display  system  until  aoain  linker!  to  so^e  object 


from  t  h  e  a  i  s  n  1  a  y  system 
list    rp-o  i  n   unchspnpr 

=i  c  c  e  s  s  e  a       t  y  t  h 


The  norrfa)   return  value  is  zero. 


i  nTi  cat  e<1  h v  npaaf  ; 


DI  AGNUS  1  ICS: 

All    errors  ^  r 

The  error  values  a  n  d  their 

-£.  The  element  does 

—  U  The.        plp^-pnt         nurnhp,r         is 


m  e  a  n  i  n  i 
not     exist. 


r  r*  * 

r  f 


*'s  *> 


the  element  n  u  f"  h  ^  r  is  ne<' 
cj  r  e  a  t  e  r  than  t  n  e  maximum  n  u  m  n  e  r 
m  i  t  t  e  a  in  t  n  e  system. 


five 


a  S   f  O  i  I  O  v. 

f   ?erci 


«  !  P 


t 


O  r 
e  r  - 


SEE  ALSO: 


v  a  a  dde 1 e ( ) #  v o  a  n  o  o  h j  (  ) 
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v  q  d  e  1  o  b  j 


Mar  IS  197b 


vooel o b  j 


NAME : 


vadelobj  -  delete  object 


SYNOPSIS: 

vqde  1  ob  j  (num) 
i  nt  nut1! 


DESCRIP1 ION: 

Remove  the  object*  nu",  f  row  the  d  i  s  d  1  a  y  svste^. 
This  also  dpi  et  ps  all  p1  prrent  s  linked  to  the  o  t  j  o  c  f  . 
The  contents  of  the  o  i  s  r  1  a  v  lists  linked  to  the 
object  rprr-n  n  unchanaen;  however*  the  display  cannot 
access  any  of  tKe  n  1  e  n-  e  n  t  s  unril  acain  linked  to 
some  object. 


I  h  e  rtorral   return  val  up  is  ?  -:•  r  o  . 


DIAGNOSTICS: 

Ail   errors  are  i  n  n i  c  a  t  e  I  b v  n  e  q a t  i v  c     return  vain 
The  error  values  and  their  t  e  a  n  i  n  q  s  a  r  e  as  follows: 
-1     The  object  number  is  n  en  a  t  i  v  e  o  r     /pro. 

-£?    1  he  object  has  -c'  been  opf  i  n-  :. 


SEE    ALSO: 


vorlple'et  )  »     vo-"  «•  ob  j  (  ) 


S8 


vqdi  a  1 


Mar  lb  \97h 


vaoi a  1 


NAME 


vqdial  -  aet  analoa  dial  values 


SYNOPSIS: 

vgd  i  a  1  ( abp ) 

<nt  *  a o p J 


DE SCRIPT  ION: 


Obtain  t  r>  e  tnn  vector  opnpral  ai  a  I  vahiPS  snl  return 
their  to  the  caller  b  e  a  i  n  n  i  n  a  at  the  ten  -,  c  r  o  i  u  ^ p  r 
point  en     to    by     a  tip. 


DIAGNOST 1CS: 

The       onlv        error 
rcinter     is     z^rc. 


c  ode     is    -6 . 


Th 


n'pans     t  •■  --     njf  f  pr 


SQ 


vgoe t car 


Mar  15  1976 


vqqet car 


NAME 


vaaetcar  -  get  keyboard  character 


SYNOPSIS: 

vqaetcarC ) 


01  SCRIPT  ION: 

An  e  i  a  h  t  bit  ASCII   character   is 
caller.    If   no   character   has 
returned. 


ret  umea 
een  i  n n u t 


to   the 
a  - 1  is 


A  four  character  Queue  is  maintained  by  t^e  svste^. 
This  pprri  ts  so^p  variation  in  :  '■"•:ssir":  t  i  *>  e 
without  character  loss.  The  Queue  c  a  ^  re  cleared  ^r 
ail  previous  c  h  a  r  a  c  t  ^  r  s  by  a  OLE  cf'enc^er  f  r  o r  t  r  e 
vector  c9"°m1  <eyboarn. 
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vqqe t f  s  w 


Mar  IS  1976 


vonet  f  s w 


name  : 


vgqetfsw  -  get  function  switch  values 


SYNOPSIS: 

vgae t  f  sw ( abo ) 

i  n  t  *  abp  ; 


DESCRIPTION: 

Read  the  thi  rtv-two  function  switches  and  return 
the"1  to  the  caller  start  ina  at  tip  t*o  worn  ruffer 
pointed  to  hv  aon.  bach  bit  represents  one  function 
switch.  If  a  bit  is  set  »  the  function  s  >-  itch  is 
deorpssed. 


D I  A  G  0  N I S  T  I  (   : 

A  -6  is  returnee;  if  the  buffer  cci  nt  "r  is  ?  e  r  i 


SEfc  ALSO: 

v  a  1  a  ~  o  s  (  ) 


61 


vgge  t 1 pn 


Mar  15  197b 


vaaet 1 pn 


NAMt: 


vqaetlpn  -  get  light  Den  interruut  values 


SYNUPSI5: 

vqaet 1  on ( ahp ) 
i  nt  *  abo ? 


DESCRIPTION: 

Seven  light  cen  interrupt  values  are  rpan  into  a 
seven  word  buffer  beoinnina  at  t  n  e  buffer*  nomteo  to 
by  atr-. 

The  rneaninq  of  p^cr  word  is: 

Word   0   -   The   element   number  of  the  o  i  s  p  1  a  v  list 

hpma  displayed  at  the  time  of  r^e  interrupt  . 
.'on  1  -  Instruction  word  b  e  i  n  a  exec  u  tea  =»  t  tn°  t  i  •  <-> 

of  the  interrupt . 
r  o  r  ct   c?   "  r  h  e  number  of  <  o  r  d  s  e  *  P   .  *     f  r  c  r  tr.p  r  e  ~ 

airninn  of  the  rli  snlsy. 
.'  o  r  d   5  i  U  i  S   -  r  h  e  >  »  Y/  Z  coordinates  respectively  at 

the  t  i  t»  e  of  the  interrupt. 
'.'.org  n  -  Pen  resolution  count. 


UI AGNUS? ICS: 

A  return  of  - 6  indicates 


buffer  pointer  c  f  ?  e  p  ° 


set.  also: 

vq  1  prn (  ) 


LI  MI  TAT  IONS: 

.'.ore   2 


does   rot  provide  any  use+u 
T  *■  <=  valup  is  the  total 
execute o   from 


rot  pro 
tnp  user.   Its 
tiers   execute^ 
has  no  relation  to  t 

rent. 


he 


in^rrat  ion     to 
•V)F>  r     o  f      instruC- 
the    start     of     the    picture.        It- 
instruction    court     of     an       ele- 


b? 


vq  i  n  i  t 


Mar  lb  l«7b 


vaini t 


NAMfc: 


vginit  -  vector  general  display  initialization 


SYNOPSIS: 

vq  i  n  i  t  (  ) 


DESC^IPT IUN: 

This  routine  performs  all  disolav  initialization  and 
aefault  parameter  -assignment.  Inp  vector  General  is 
accessed/  clearen,  an  ci  reset  for  ai  sol  ay  operations. 


This  routine  must  Oe  colled  hpfore  any 

t ions. 


display 


ac  - 


:  \  G  .  J  S  T  1  C  S  : 

If   the  initialization  cannot  he  completed/  an  error 

m  e  s  s  a  o  e  is  p  r  i  n  t  e  d  and  t  r  p  process  is  t  e  r  -■  i  r-  a  *  e  ■ . 
Error  messaoes  usually  occur  because  a^ot^er  process 
is  a  real-time  :  f-r-cpss  or  because  the  vector  -j  e  n  e  r  a  1 
has  been  accessor  by  another  usrr. 


hi 


vq  i o  f se  t 


Mar  IS  197b 


vqiofspt 


NAME  : 


vqiofset  -  modify  intensity  offset 


SYNOPSIS: 

vqiofset  (nurr,va1  ) 
i  n  t  num ; 
double  val; 


DESCKIP1 ION: 

Set  the  ^axi^urr  1  p  v  e  1  of  intensity  permitted  for  the 
object*  num.  v  a  1  *  between  zero  an'!  one*  is  a  m  e  a  s  - 
ure  of  the  maximum  intensity  of  the  object.  The 
intensity  is  maximum  at  the  face  of  the  screen  a n ci 
Decreases  exponentially  t  o  w  a  r  o  t  h°  hack  of  the  im- 
age. If  val  is  n  e  native*  a  screen  cut-off  is  im- 
posed.   If   the  transformeo  value"-  of  the  Z  coordi- 


nate axis  are  ireater  than 


n 


t  h  p  y  are 


a  r,  <  p  o  . 


The  normal  return  v  a  1  u  p  is  zero. 


A]l  errors  <i  r  e     i  nnicateri  by  n  e  a  a  t  i  v  e  return  value 

I  h  e  e  r  r  c  r  values  a  n  ri  t  h  p  i  r  rr  «=>  a  n  i  n  a  s  are  as  follows 

-1  Ino  oojpct  number  is  n  e  a  a  t  i  v  e  or  zero. 

- d  The  object  does  not  exist. 


SEE  ALSO: 


va  i  sc  a  1  C  ) 


6a 


vqi sea 


Mar  IS  1976 


vq  i  sc  a 1 


NAME: 


vqiscal  -  modify  object  intensity  scale 


SYNOPSIS: 

vqiscal ( num ,va1 ) 

i  n t  nun; 

o o u D 1 e  val  ; 


DESCRIPI ION: 

The  intensity  r  a  n  q  e  of  the  object/  n  u  m  ,  is  letpr- 
mined  b  v  val.  If  val  is  ore*  the  maxinui"  intensity 
range  is  achieved.  f  *  the  value  is  z?roi  the  inten- 
sity is  constant  and  the  i^aoe  has  no  depth-cueirc. 


N  o  r  ti  a  1  return  is  ;ero. 


DIAGNOSTICS: 

a  1  I  prrors  are  indicated  hy  neoat  i  ve  return   values. 
1 h  e  error  values  and  t  ^  e  i  r  meanings  are  as  follows: 
-1    1 ne  object  number  is  neoat ive  or  zero. 
- c*    Ihe  object  r  j  o  e  s  not  exist. 


SEE  ALSO: 

vo  i  c  f  se  t  (  ) 


oS 


vq 1  amps 


Mar  IS  1976 


vq 1  amps 


NAME 


vqlamps  -  1  i  a  h  t  function  switch  lamps 


SYNOPSIS: 

vo 1  amps ( abo) 
i  nt  *  at)p  ; 


DESC^IPT ION: 

Liaht  the  function  switch  lamps  of  those  function 
switches  with  •=)  nit  set  in  the  two  »cni  buffer 
nointpi  t  c  by  a  b  o .  t  acn  bit  position  corresoonas  to 
one  of  the  thirtvtwo  function  switch  larcs. 


DIAbfJOST  ICS: 

If  the  Puffer 


omter  is  z  &  r  o  t     a  "6  is  returned 


SE fc  A  L  S  0  : 

vqqetf Sw() 
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vo 1  pen 


Mar  IS  1976 


vq 1  pen 


NAMfc: 


vqlpen  -  set  or  clear  liaht  pen  hookability 


SYNOPSIS: 

va!pen(tvpe»nuT:»act  ion) 
char  t  voe ; 

int  nu!T!»action; 


Dfc"  SCRIPT  ION: 

Ihp  liaht  o  p  n  h  o  o  k  a o  i  I  i t  v  of  the  entire  nicture#  a 
si  nal  e  c  r  j  p  c  t  ,  cr  a  si^nl  e  element  m  a  v  t~  e  set  or 
cleared.   The  fellow  inn  nara^etpr  values  aroly 

TYPt 

0 

Mnni f v  the  entire  oicture. 

1 

'■''  c  rf  i  f  y  the  o  b  j  e  c  t  ,  num. 

2 

Modify  the  element  »  nu". 

ACTION 

Clear  the  liaht  :^n  hookability. 

1 

Set  the  I  i  a  h  t  pen  hookability. 

1  he  normal  return  value  is  a  zero. 


DIAGNOST ICS: 

All  errors  are  innicated  by  nenat  i  ve  return   values. 
The  error  values  ana  their  meanings  are  as  fnl lows! 
-1    The  object  n  u  m  o  e  r  is  neaative  or  zero. 
- 2  lip  onject  or  element  oops  not  exist. 

-4  f he  element  number  is  negative*  zero*  or 
or^ater  than  the  maximum  number  of  elements  per- 
mitted in  the  pntire  System. 


hi 


vgmk  ob  j 


Mar  IS  19  7b 


vqmkoh j 


NAMh  : 


v  g  m  k  o  b  j  -  make  object 


SYNOPSIS: 

vgmkobj ( ) 


DESCRIPTION: 

Create  an    emotv   object   structure   and   return   the 
object  number  to  the  caller. 


DIAGNUST ICS: 

A   -3  is  returnee]  if  all  available  otjects  have  heen 
previously  assianei. 


6  8 


vod icture 


Mar  IS  1976 


vqp  icture 


NAME: 


vgpicture  -  display  oicture 


SYNOPSIS: 

vqp  icturet ) 


DESCRIPTION: 

Send  the  vector  aeneral  display  list  ana   start   the 
display. 
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vqDOSt 


Mar  IS  1976 


vqpos t 


NAME: 


vqpost  -  modify  the  oicture  coordinate  axis 


SYNOPSIS: 

VQPOSt (  c  x  ,  n  y  ) 
i  n  t   O  X  t  P  V  r 


0ESCW1PT ION: 

Modify  the  t  r  a  n  sforxen  X ,  Y  coordinate  points  of  each 
irraqe  in  the  oicture  by  ox  and  p y  respectively.  The 
oriainal  a  i  s  d  1  a  y  lists  remain  unchanged.  'he  ranae 
of  values  are  -?047  throuqh  +204  7. 


SEE  4 L  S  0 : 

v;:conro(  ) 
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vqosc  a  1 


Mar  15  1976 


vnpscal 


NAME: 


vqpscal  -  modify  picture  scale 


SYNOPSIS: 

vgnsca 1 ( va 1 ) 
3  o  u  b  1  e  v  a  1  ; 


DESCPIPT ION: 

Scale  each  coorainate  of  all  elements  r  y   v  a  1  .    Ihp 

original  d  i  S  o 1  a  y  list  r  e  r  a  i  n  s  unchanoea.   A  v  a  1  up  of 

one  oives  the  larapst  picture.   A  value  of  zero   the 
sma 1  lest  . 
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vapotate 


Mar  IS  1976 


vqrotate 


NAMh  : 


vgrotate  -  rotate  object 


SYNOPSIS: 

varotate(nuT,x#y/z) 
int  n  u r ; 
douD I e  x ,  y  ,  2 ; 


DESCRIPTION: 

Rotate  the  onjpct  /  nuii,  about  the  x,  Y  ,  and  7  axis. 
The  inout  parameters  are  radian  measure  rotation 
aoout  the  axis  indicated,  Ml  elements  I  m-eo  to 
the  objpct  are  affected.  Th,p  c  r  i  q  i  n  a  1  oisrlay  lists 
regain  unaffected. 


1? 


vaterm 


Mar  IS  1976 


vaterm 


NAME: 


vgterm  -  terminate  vector  aeneral  display 


SYNOPSIS: 

vq t  e  rm (  ) 


DESCRIPTION: 

Terminate  access   to  the  vector  oenpral  ano  release 

all  system  resources.   This  should  he  called  at   the 

conclusion  of  all  disolay  operations. 
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APPENDIX  A 
ASCII  CHARACTER  CODES 


Table  A  - 1  lists  the  ASCII  copies  useo  b  v  the  display 
system  for  the  various  general  and  SDPcial  characters. 
The  codes  are  q  i  v  e  n  in  octal  notation.  The  octal  codes 
are  aiven  as  thouah  there  u  e  r  e  eionteen  bits  in  the  data 
word  instead  of  sixteen  oits.  Since  two  characters  can  be 
aiven  in  pacn  oata  word,  the  octal  codes  are  aiven  for  the 
r  i  a  h  t  half-word  and  the  left  half-word.  The  left  half- 
wora  cone  is  aiven  as  thouah  there  were  no  character  in 
the  ngnt  half-word.  To  obtain  t  n  e  complete  code  for-  the 
two  characters  in  a  w  o  r  n ,  the  js«r  - u  s  t  aoo  the  two  codes 
tooetner.  For  examole*  '  f  the  character  C  is  to  be  in  the 
left  half-word  and  the  character  A  is  to  n  e  in  the  riant 
ha  If- word,  t  n  e  coae  would  he: 


c 

o  a  l  a  u  o 

A 

0  1  ')  1 

CA 

0  a  1  S  0  1 
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tabu:  a-i 


OCT 

AL 

CHARACTF 

:r  generator 

KEYBOARD 

LEFT 

RIGHT 

SYMBOL 

SYMBOL 

000000 

000 

NULL 

( i  ono  red ) 

a 

Ctrl 

000400 

00  1 

SO 

( i nnored) 

A 

Ctrl 

0  0  10  0  0 

0  02 

STX 

( i  ano rea) 

B 

Ctrl 

00  la oo 

003 

ETX 

(  i  nnorprt) 

C 

Ctrl 

0  0  2  0  0  C 

0  04 

EOT 

( ianorea) 

D 

Ctrl 

o  o  2  4  o  o 

0  05 

ENQ 

(  ianorpfi) 

r 

Ctrl 

0  0  3  0  0  0 

006 

ACK 

(iqno red ) 

F 

Ctrl 

0  0  34  0  0 

00  7 

BEL 

(iinoroo) 

G 

Ctrl 

0  0  4  0  0  0 

0  1  0 

BS 

H< 

0  0  4  4  0  0 

01  1 

HI 

( L  F ,  cent) 

I 

Ctrl 

0  0  5  0  0  0 

012 

LP 

Lf 

0  05400 

01  3 

VT 

(ton*  c  en  r  ) 

K 

Ctrl 

0  0  o  0  0  0 

0  1  4 

FF 

C  t  o  o  $     left) 

L 

Ctrl 

0  0o4  0  0 

015 

NL 

(  C  R ,  L  F  ) 

CR 

0  0  7  0  0  0 

0  In 

SE 

(  i  morp'i) 

n 

Ctrl 

1 1  0  1  4  M 

0  1  7 

SI 

1  -1  :^nron) 

u 

Ctrl 

010  0  0  0 

DLt 

p a r  uueue ) 

p 

c^rl 

0  1  0  4  'J  0 

1  2  1 

DC  1 

C-LF  ) 

0 

Ctrl 

0  1  10  0  0 

0  22 

D(  2 

(-SZ  ) 

h 

Ctrl 

0  1  14  0  0 

02  3 

C  +SZ  ) 

s 

Ctrl 

012  0  0  0 

02a 

D  C  J 

(term) 

T 

Ctrl 

012  4  0  0 

0  2  5 

U  A  K 

(ignore  :  ) 

U 

Ctrl 

0  1  7- 

t 

Si'. 

(icnorpo) 

'v 

Ctrl 

0 1 34 0  0 

027 

F  i  - 

(  i  :'"r";l) 

/. 

Ct  rl 

0  1  u 

(  i  o  n  o  r  e  a  ) 

' 

Ctrl 

0  1  u  4  0  0 

031 

F.v 

( i irnrpil 

Y 

Ctrl 

0150  0i 

0  32 

SUB 

(  i  -^ored) 

7 

Ctrl 

0154  0  0 

0  3  3 

■  ESC 

(esc  ) 

[ 

Ctrl 

0  1  b  0  0  0 

0  3  4 

FS 

( i qnored) 

c  t 

rl 

0164  0  0 

035 

GS 

( ionnrea) 

J 

Ctrl 

0  01  /  0 0 

03o 

RS 

(ionored) 

ci 

rl 

0  17  4  0  0 

037 

US 

( i  ono  reo ) 

0200  00 

040 

Srac  e 

sc  bar 

020400 

041 

i 

1 

shi  ft 

0  2  10  0 0 

0  42 

ii 

? 

shift 

021400 

0  4  3 

~ 

5 

Shift 

022^  10 

0  44 

f 

4 

shift 

022400 

0  4  S 

': 

5 

shift 

0230  >G 

0  ifa 

-. 

b 

shift 

02  34  0  0 

• 

7 

s  -  i  f  r 

0  2  u  U  0  0 

( 

h 

Shift 

0  2  u 

05  1 

) 

q 

Shi'f 

0  250  0  0 

0  52 

• 

• 

shift 

025400 

OS"  5 

*■ 

t 

shift 

026  0  0  0 

054 

> 

r 

0  2  b  a  0  0 

055 

- 

- 

02  7 

0  5n 

• 

• 

75 


TABLE  A-l 

027400 

057 

/ 

/ 

030000 

060 

0 

0 

0  30  4  0  0 

061 

1 

1 

0  3  10  0  0 

062 

2 

2 

031400 

063 

3 

3 

032000 

064 

J 

a 

032U00 

065 

5 

5 

0  330  0  0 

066 

6 

6 

0  3  34  0  0 

0  67 

7 

7 

034000 

070 

8 

8 

034  4  0  0 

071 

u 

9 

0  350  0  0 

0  72 

• 
• 

• 
• 

0  354  0  0 

075 

t 

' 

0  36  0  0  0 

07  4 

< 

t 

Shift 

0  36  4  0  0 

0  /5 

- 

- 

Shift 

0  3  7  0  0  0 

0  7b 

> 

• 

Shift 

0  37 400 

077 

-3 

• 

0  4  0  0  0  0 

1  0  0 

v 

rl 

04  04 0  0 

1  0  1 

.•. 

3 

shift 

04  1 

1  0  2 

H 

H 

shift 

04  1  J  i 

1  i  ■■ 

C 

C 

Shift 

0  4  2000 

1  0  4 

D 

0 

shift 

0  4  24  0  0 

105 

E 

I 

s  h  i  ft 

0  4  30  0  0 

1  0  6 

F 

F 

Shift 

0  4 54  0  0 

1  0  7 

G 

G 

shift 

0  4  4 

1  10 

H 

H 

31-  i  f  t 

0  4  4  4   0 

\   1  1 

] 

1 

Shift 

0  4  5 0 0 0 

1  12 

J 

J 

s^ift 

0  4  5  4  0  0 

1  1  3 

K 

K 

Shi  ft 

0  4 1 0  0  0 

1  14 

L 

L 

shift 

0  464  0  0 

1  15 

M 

l\l 

shift 

0  4  7  0  0  0 

1  16 

N 

N 

Shift 

04  7  4  0  0 

1  1  1 

'■ 

(i 

Shift 

0  5  0  0  0  0 

1  2  0 

P 

P 

Sh  i  f  r 

0  5  0  4  0  0 

121 

Q 

Q 

Shift 

0  510  0  0 

122 

K 

R 

Shift 

0  514  0  0 

123 

s 

S 

Shift 

0  5  2  0  0  0 

124 

I 

T 

Shift 

0  5  2  4  0  0 

125 

u 

u 

Shift 

05  30 C 0 

126 

V 

V 

Shift 

053400 

127 

v\ 

/, 

Sh  i  f  r 

0  ;-  4  0  0  0 

1  5  0 

X 

* 

Shift 

054  4  I 

1  3  1 

Y 

Y 

shift 

1  32 

/ 

/ 

Shift 

C:L-  ■ 

1  3  3 

I 

I 
\ 

0  5  d  0  0  0 

1  34 

\ 

0  5  b  4  0  0 

1  35 

1 

1 

0  5  7  0  0  0 

1  3n 

A 

•\ 

0  5  7  4  0 0 

1  37 

(su 

h-  ,  sure  rsc  r 

int) 

i 

1 

% 

n 

3  h  i  fr 
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TABLE.  A-l 

060UOO 

141 

a 

A 

061000 

142 

b 

B 

061400 

143 

c 

C 

062000 

1  4  4 

a 

[".' 

062400 

145 

e 

E 

06  3  0  0  0 

146 

f 

F 

063400 

147 

g 

G 

064  0  0  0 

150 

h 

H 

064  4  0  0 

151 

i 

I 

0650  0  0 

152 

J 

J 

065400 

153 

k 

K 

OtofaOOO 

154 

i 

L 

06o400 

155 

FTl 

M 

06  7  0  0  0 

156 

n 

N 

0  6  7  4  0  0 

157 

0 

0 

0 7  0  0  0 0 

160 

P 

P 

0  7  0  4  0  0 

161 

q 

Q 

0  7  1  0  00 

lb2 

r 

»< 

0  7  14  0 0 

163 

5 

S 

0  72000 

1  ^4 

t 

T 

0  7  2  4  0  0 

165 

u 

U 

0/3000 

1  no 

V 

V 

0  7  34  0 

I  fa  1 

w 

.". 

0  74  0  0  0 

170 

> 

X 

0  7  4  4 

1  71 

V 

Y 

0  7  5  0  0 0 

1  72 

7 

Z 

0 754 Ou 

1  75 

< 

1 

Shift 

0 76  0  0  0 

!  7m 

1 
1 

\ 

Shift 

0764  0  0 

1  75 

} 

! 

Shift 

0  7  7  0  0  0 

!  7o 

r^i 

A 

Shift 

0  7  74  0  0 

1  77 

ae  1 

DEL 

1  0  0  0  0  u  - 

200- 

117  4  0  0 

237 

12  0  0  0  0 

2  4  0 

a 

space  s 

120400 

241 

1 

1 

shf  t 

1210  0  0 

24^ 

II 

2 

Shf  t 

1  2  1  a  0  0 

243 

O 

3 

Shf  t 

1220  0  0 

24  4 

£ 

4 

Sh  ft 

122400 

24b 

V 

5 

Sh  f  t 

12  30  0  0 

24o 

/ 

(  C  a  n  t  p  r  e  1  ) 

6 

Sh  f  t 

12  3400 

247 

• 

J 

Sh  f  t 

1  2  4  0  o  0 

250 

cz. 

»- 

Shf  t 

124400 

251 

Z> 

q 

Sh  ♦  t 

125000 

2^2 

10 

(  suoscriot ) 

; 

S  h  f  t 

1254 

253 

-f- 

i 

Shf  t 

12c C 0  0 

254 

JL 

t 

sp<  c 

12o- 

255 

SS 

- 

S  C  °  C 

127U00 

25b 

> 

. 

srec 

127  4  0  0 

257 

-1 

/ 

snec 

1300  H 

2t>0 

0 

0 

sr  ^ c 

spec 
spec 
spec 
srec 
spec 
spec 
spec 
spec 
spec 
s  r  e  c 
sr^c 
srec 
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TABLE  A-l 

130400 

261 

r 

1 

soec 

131000 

262 

V 

2 

spec 

131400 

263 

□ 

3 

spec 

132000 

264 

t 

4 

spec 

132400 

265 

A 

(cent  ered ) 

5 

spec 

133000 

26o 

a 

o 

spec 

1 53400 

267 

2 

7 

soec 

1  34000 

270 

u 

8 

srec 

13  4  4  0  0 

271 

0 

Q 

soec 

155000 

272 

• 

(center  no t ) 

• 

soec 

155400 

273 

X 

f 

spec 

1  5n000 

274 

*- 

f 

sn  f  t 

scec 

14  6  4  0  0 

3  15 

cm 

M 

shf  t 

srec 

14  7  0 0 0 

316 

"n 

>. 

si  f  t 

srec 

1  4-7  400 

31  7 

A 

0 

sn  f  t 

srec 

1  5  0  0  0  0 

32  0 

TT 

p 

Sn  f  t 

scec 

150  4  0  0 

321 

0 

Q 

sh  f  t 

spec 

1510  0  0 

322 

J> 

R 

Shf  t 

s  pec 

1514  0  0 

525 

- 

S 

S  *  ft 

nee 

15c 

32  4 

e 

T 

E   ft 

soec 

1  5  2  - 

525 

! 

l.  J 

Sbft 

sr«'C 

15  3000 

52o 

/ 

v 

sh  f  t 

sn  pc 

15  3  4  0  0 

32  7 

A 

i\ 

Sh  ft 

srec 

154  0  0  0 

3  50 

f 

X 

sHf  t 

SO  PC 

154  4  I 1 1 

331 

r 

Y 

Snf  t 

srec 

1  5 c^ 

• 

— 

z 

shf  t 

srec 

1 554  0  0 

33  5 

L 

; 

5h  f  t 

spec 

1  5  b  U  0  0 

5  34 

=> 

spec 

1  5  6  u  0  0 

3  55 

h 

1 

Sh  f  t 

s  r  e  c 

15  7  0  0  0 

5  36 

—  * 

A 

soec 

157400 

337 

.   0    * 

.  st  ec 

1  o  0  0  0  0 

34  0 

«_J 

( b  1  inHnq) 

a> 

s^  f  t 

soec 

16  0  4  0  0 

34  1 

*c 

A 

shf  t 

srec 

16  10  0  0 

54? 

£ 

B 

Shf  t 

srec 

1614  0  0 

54  3 

V 

c 

sr  f  t 

srec 

162000 

344 

5 

1) 

Sh  f  t 

scec 

lb2400 

5^5 

€ 

E 

s^  f  t 

srec 

I  o  3  0  0  0 

5  '4  6 

0 

F 

Sh  f  t 

sr  pc 

16  34  0 

34  7 

7 

G 

snf  t 

soec 

16^00 o 

55  0 

1 

H 

snf  t 

srec 

16  4  4  0  0 

55  1 

6 

I 

Sn  f  t 

soec 

1  6  5 

5r>2 

-»■* 

J" 

Sh  f  t 

srec 

1 654  0  0 

5^5 

/  * 

- 

s  -  f  t 

-.  -  .  - 

1  6  O  1 

55u 

X 

L 

S  n  f  t 

s :  r  c 

'  •  bUf!  C 

555 

M 

Sh  f  t 

so°c 

1  g  7  0  0  0 

!   ■ 

y 

'■ 

s~  f  t 

.  ' 

1  e  7  u  0  G 

357 

w 

0 

s^ft 

Si  e C 

1  7000  0 

56  0 

rr 

^; 

s*  f  t 

soec 

1  70400 

36  1 

E 

Q 

su  <  t 

so^c 

1  7  1  ( 

5  fc  2 

<° 

■- 

§h  ft 

st  e  c 

78 


171400 
172U0  0 
1  7  2  4  0  0 
1730  0  0 

173400 
174000 
17  4  0  0  0 
1  7UU00 
1  7  b  0  0  0 
175400 
17  6  0  0  0 
176  4  0  0 
17  7  0  0  0 


365 
364 
365 
366 
367 
370 
371 
37? 
373 
374 
375 
376 
37  7 


TABLF  - 

*-l 

<r 

s 

shft 

spec 

T 

i 

shft 

spec 

3 

u 

shft 

spec 

O 

J 
■ 

V 

Shft 

spec 

A 

Shft 

spec 

i 
o 

X 

Sh  f  t 

spec 

Y 

Shft 

SPPC 

% 

Z 

Shft 

spec 

r 

[ 

spec 

shft 

I 

spec  s 

h  f  t 

H 

] 

soec 

Shft 

/v-»  # 

soec 

Sh  ft 

EZ3 

DEL  spec 

#  Superscript 
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APPENDIX  H 
SAMPLE  PROGRAM 


The  sample  proaram  described  her?  is  a  box  containino 
a  zigzaq  line  and  the  word  box.   This  oroqram  is  not  in- 
tended to  illustrate  all  of  the  features  of  the  vector 
aeneral  interface  but  to  illustrate  onp  mv  of  oevelooino 
a  display  picture. 


1 

? 
3 
d 
5 
fo 
7 

1  0 
1  1 

la 

13 
lu 
15 
lb 
17 
lfl 
1^ 
20 
?\ 
2£ 
?3 
?a 

as 
an 
a  7 

a* 

a^ 

30 

3  1 

^a 


define  ■■■ r  -r<n  J  0 
define  APF.LE  1 
define  ' J  J   a 


/ /  make  object 
/ /  ado  element 
/ /   and  object 


ipscrinma  a  oox 


/  U  i  so  1  a v  list 
n  t  cox   [10] 
< 

0  1  0  0  0  4  ,  /  / 

0  10  0  0  0!,  / / 

o  i  o  o  o  i  a ,  /  / 

0  7  7  7  65,  / / 

0/7766,  /  / 

0  10  0  0  0  5,  / / 

0  10  0  0  1b,  / / 

ooooooo,  / / 

oooo  o  o  o ,  // 

ooooooo  /  / 
) ; 

/    Character  display 
nt  v.  orcj  [7] 

< 

010157,  // 

0  1  0  i   I  o  ,  /  / 

0  0  1  1  S  7  ,  /  / 

o7uoau,  // 

OOUOQO,  // 

oooooo,  // 

0  0  0  0  0  0  / / 

}  ; 


vector  absolute  inst 
1 o a d  a  coordinate 
loan  V  cooro.  and  move 
load  x  cooro,  a n d  t  r  a w 
load  Y  coord,  and  craw 
cooro.  a no  or  a  v 


coord.,  draw  8.  ter" 


lnad  X 
loao  r 

f'lOOD 

Mood 
Nood 


list  s  p  e 1  1  i n  q  the  word  box 


char  Generation  inst 


- 

ASC  1  I 

N  o  on 
"loop 
•M  o  o  o 


me  f  e  e  i 
b  v  t  e  s  ,  " 
p  v  t  e  s  /  < 


■-  st  ac  e 

I  -   ! 

<  term. 


R0 


33 

3^ 
35 
36 
37 
38 
39 
40 
4  1 

42 

43 

44 
45 

4  5 
47 
48 
49 

5  0 
5! 
52 
53 
5a 
55 
5b 
57 
5* 
59 

6  0 
61 
62 
b3 
6^ 
65 
66 
67 
68 
69 
70 
71 
72 
73 
7a 
75 
76 
77 
7H 
79 

^0 
81 
82 


//  Zigzaa  line  display  list 
i  nt  ?i  q  I  12] 
{ 

0  10  0  11, 

0771 76, 
077602, 
077602, 
0  7/602, 
07  /602, 
0  7  7  6  0  2, 
07  76  0  2, 
0  7/603, 

oooooo, 

0  0  0  0  0  0, 

oooooo 
}  ; 


Ta i  n (  ) 
{ 

i  nt  e  1  e  1  ,  e 1 e2,  e  1  e3 ; 
i  n t  ob  j  W  or jt,  ob j  3; 


//   2D  vector 

i  nc  remen  t  a  1 , 

//   X  auto-increment 

/ /   move  Y 

//   i 

nc  rement 

X, 

draw 

Y 

//   i 

nc  rement 

x, 

draw 

Y 

//   i 

nc  rement 

X  , 

draw 

y 

//   i 

nc  rement 

x, 

draw 

r 

//   1 

nc  rement 

x, 

draw 

Y 

//   l 

nc  rement 

X  , 

draw 

Y 

//   1 

nc  recent 

A  , 

draw 

y  a 

//  r 

Jooo 

/  /    N  O  O  D 

/ /   N oop 

v  o  i  n  i  t  (  )  ; 


//  initiate  vector  nenpral 


//■'ake  t  ^  r  p  e  objects 

if  ((objl=vqmnobjO)  <  0  )  e  r  r  o  r  ( '•'  K  0  b  J )  ; 

if  (Cobj2  =  vqmkor)j())  <  0 )  error(''i«UiJ)  ; 

if  ( (ob j 3  =  vdmkcb j  ( )  )  <  0)  e rror (MKOBJ ) ; 

//Ann  tne  display  lists  to  the  objects 
if  (  (  e  1  e  1  =  v  a  a  d  n  e  1  e  (  b  o  x  ,  o  b  j  1  ,  2  0  )  )  <  0  ) 

errorfADELF); 
if  ((ele2  =  vqaddele(word,obj2,14))  <  0 ) 

error (ADELF ) ; 
i  f  ((ele3  =  vaaooele(?ia,orj3,2  4))  <  0 ) 

errnr(ADLLF); 

/  /  A  a  v-j  the  oojects  to  the  cicture 

if  ( vaadaobj (ob j 1)  <  0)  error ( A DOB J ) ; 
if  (vaacdobj(cbj2)  <  ft)  error(ADQBJ); 
if  (vaadaobj(obj3)  <  0)  error(ADOBJ); 


vopict'ure(  )  J 
sleep(6U); 
v  q  t  e  r  m  (  )  ; 
} 


term 


//  start  display  c  *  oicturp 

//  wait  o  0  secnnos 

//  termipate  display  operations 


81 


83 

8a 

85  error(msa) 

86  i  nt  msqj 
67       { 

88  sw  i  t  c  h  (rrsa) 

89  { 

90  case  MKOBJ: 
<M  { 

9<?  printf("make  object  errors"); 

9  3  break; 

9a  } 

95  case  ADELE: 

9b  { 

97  print  f ("a^d  element  error"")) 

9  8  break; 

99  } 

100  case    iDUiiJ: 

10  1  < 

10?  printf  Ca-id  object  prrcr="); 

10  3  r  rea<; 

10  a  > 

105         } 

10b  vlter^Ol 

10  7  e  v  i  t (  )  ; 

toe    > 


8  a 
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